/*   **********************************************************************  **
 **   Copyright notice                                                       **
 **                                                                          **
 **   (c) 2003-2005 RSSOwl Development Team                                  **
 **   http://www.rssowl.org/                                                 **
 **                                                                          **
 **   All rights reserved                                                    **
 **                                                                          **
 **   This program and the accompanying materials are made available under   **
 **   the terms of the Common Public License v1.0 which accompanies this     **
 **   distribution, and is available at:                                     **
 **   http://www.rssowl.org/legal/cpl-v10.html                               **
 **                                                                          **
 **   A copy is found in the file cpl-v10.html and important notices to the  **
 **   license from the team is found in the textfile LICENSE.txt distributed **
 **   in this package.                                                       **
 **                                                                          **
 **   This copyright notice MUST APPEAR in all copies of the file!           **
 **                                                                          **
 **   Contributors:                                                          **
 **     RSSOwl - initial API and implementation (bpasero@rssowl.org)         **
 **                                                                          **
 **  **********************************************************************  */

!! THIS DOCUMENT IS ONLY IMPORTANT IF YOU HAVE DOWNLOADED THE BINARIES OF RSSOWL !!
	

Installation notes for RSSOwl:
------------------------------

 	Step 1) Java Runtime Environment

    In order to use RSSOwl your computer must have installed Java.

    You can get Java from here: http://www.java.com/en/download/manual.jsp
    
    Follow the instructions as mentioned in "Step 2: Install" if necessary.


	Step 2) Installation of the Standard Widget Toolkit (SWT) graphic libary

	If you get the following error after execution:

    "Exception in thread "main" java.lang.UnsatisfiedLinkError: no swt-win32-30xx in java.library.path", there are
    some ways to get it start correctly:

    Windows:

	  1)
      Make sure the "rssowl.jar" and the "swt-win32-xxxx.dll" are in the same directory
      (they should, after unzip). Doubleclick the JAR-File. If an error occurs, try to
      execute the following command from the windows commandline:
      "java -jar -Djava.library.path=<Path to RSSOwl> <Path to RSSOwl>\rssowl.jar"
      Replace the <Path to RSSOwl> with the path to the Directory, where the DLL is in
      (for example: "java -jar -Djava.library.path=c:\rssowl c:\rssowl\rssowl.jar").

    2)
      Put the DLL into a directory, that is known anywhere, like "C:\windows" or "C:\windows\system32" or
      the BIN-directory of you JDK.


Updating from previous Versions:
--------------------------------

Updating an existing RSSOwl is very easy!

All settings and favorites should be stored in your user-home directory in a folder
called ".rssowl" that is independant from RSSOwl's installation folder.

On Windows ".rssowl" should be located in "/Documents and Settings/user.name/.rssowl".
On Linux / Solaris take a look at "~/.rssowl", from the console by typing "cd ~/.rssowl"
On Mac the folder is located in "~/Library/Preferences/rssowl".

ATTENTION: We recommend to make a Backup of the "rssowl" folder, since it is containing
           all your settings and Favorites. Do so BEFORE installing the new Version. 

In the case you are able to locate that folder simply copy the new RSSOwl into the
same folder of the old RSSOwl, overwriting it.

In the case you are not able to locate that folder simply run the old RSSOwl, goto
"Preferences" and perform "Export Settings". That export also includes your favorites.
In the new RSSOwl goto "Preferences" and select "Import Settings". That's it :).


Support
-------

    If there are still problems with execution, feel free to write in the RSSOwl-forums @ sourceforge
    (http://sourceforge.net/forum/?group_id=86683) or visit #rssowl on irc.freenode.net.